home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_hylafax.idb / usr / freeware / man / cat1 / faxsend.Z / faxsend
Encoding:
Text File  |  1999-07-16  |  5.6 KB  |  133 lines
  1.  
  2.  
  3.  
  4. FFFFAAAAXXXXSSSSEEEENNNNDDDD((((1111MMMM))))      UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOccccttttoooobbbbeeeerrrr 3333,,,, 1111999999995555))))      FFFFAAAAXXXXSSSSEEEENNNNDDDD((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      faxsend - _H_y_l_a_F_A_X facsimile transmit program
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ////uuuussssrrrr////ffffrrrreeeeeeeewwwwaaaarrrreeee////ssssbbbbiiiinnnn////ffffaaaaxxxxsssseeeennnndddd [ ----llll ] [ ----pppp ] [ ----cccc _c_o_n_f_i_g ] ----mmmm
  13.      _d_e_v_i_c_e-_I_D _q_f_i_l_e
  14.  
  15. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  16.      _f_a_x_s_e_n_d is the program that implements the facsimile
  17.      transmission protocol for the _H_y_l_a_F_A_X system.  _f_a_x_s_e_n_d is
  18.      invoked by the _f_a_x_q scheduler process for each facsimile
  19.      transmit attempt.  _f_a_x_s_e_n_d assumes that its current working
  20.      directory is the top of the spooling hierarchy, that a
  21.      suitable modem device has been allocated for its use, and
  22.      that all documents to be sent are already converted to
  23.      TIFF/F (TIFF Class F) at the appropriate resolution and with
  24.      an appropriate data encoding.  In normal use _f_a_x_s_e_n_d will
  25.      inherit a lockfile for the modem from the _f_a_x_q process.  The
  26.      format of the job description file specified on the command
  27.      line is described in _s_e_n_d_q(4F).
  28.  
  29.      _f_a_x_s_e_n_d initializes the modem before attempting to transmit
  30.      the facsimile using the information in the appropriate modem
  31.      configuration file.  If the modem does not respond to this
  32.      initialization, _f_a_x_s_e_n_d will repeatedly try to initialize
  33.      the modem.  This behaviour is required for send-only
  34.      environments in which a _f_a_x_g_e_t_t_y(1M) process is not run (and
  35.      the modem would be known to be in a properly initialized
  36.      state).  _f_a_x_s_e_n_d catches SIGINT and SIGTERM and cleans up
  37.      any resources it controls; this is the mechanism used by
  38.      _f_a_x_q to abort a job while it is in progress.
  39.  
  40.      Many aspects of _f_a_x_s_e_n_d operation are controlled through a
  41.      configuration file.  The configuration file is located in
  42.      the spooler hierarchy in the eeeettttcccc subdirectory and is named
  43.      ccccoooonnnnffffiiiigggg...._d_e_v_i_c_e-_I_D;;;; consult _c_o_n_f_i_g(4F) for detailed
  44.      information on the contents of configuration files.
  45.  
  46. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  47.      The following options are recognized:
  48.  
  49.      ----cccc _c_o_n_f_i_g Treat _c_o_n_f_i_g as a configuration parameter
  50.                specification that is interpreted after reading
  51.                the per-device configuration file.  For example,
  52.                ``-c sessiontracing:0x4f'' would set the
  53.                SSSSeeeessssssssiiiioooonnnnTTTTrrrraaaacccciiiinnnngggg configuration parameter to
  54.                ``0x4f'', overriding any setting in the
  55.                configuration file.
  56.  
  57.      ----mmmm _d_e_v_I_D  The device to use in processing the job.  Note
  58.                that this is a _d_e_v_i_c_e _i_d_e_n_t_i_f_i_e_r and not the
  59.                pathname of the tty special file.  A device
  60.  
  61.  
  62.  
  63. Page 1                                          (printed 6/24/99)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. FFFFAAAAXXXXSSSSEEEENNNNDDDD((((1111MMMM))))      UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((OOOOccccttttoooobbbbeeeerrrr 3333,,,, 1111999999995555))))      FFFFAAAAXXXXSSSSEEEENNNNDDDD((((1111MMMM))))
  71.  
  72.  
  73.  
  74.                identifier is formed from a device filename by
  75.                removing any leading ``/dev/'' and converting any
  76.                ``/'' characters to ``_'' characters.
  77.  
  78.      ----llll        Do the UUCP lockfile protocol in _f_a_x_s_e_n_d.  By
  79.                default _f_a_x_s_e_n_d assumes that it is invoked with
  80.                the device already locked and that it does not
  81.                need to manage the lockfile.
  82.  
  83.      ----pppp        Do not change the process priority when
  84.                transmitting.  Normally _f_a_x_s_e_n_d will raise its
  85.                priority to reduce i/o latency.  This option is
  86.                useful for debugging.
  87.  
  88. NNNNOOOOTTTTEEEESSSS
  89.      _f_a_x_s_e_n_d returns the new job status to _f_a_x_q through the
  90.      _e_x_i_t(2) return value of the process:  _s_e_n_d__r_e_t_r_y (0), retry
  91.      job; _s_e_n_d__f_a_i_l_e_d (1), job finished without success,
  92.      _s_e_n_d__d_o_n_e (2), job completed successfully, _s_e_n_d__r_e_f_o_r_m_a_t
  93.      (3), job should be retried after documents are reformatted.
  94.  
  95. FFFFIIIILLLLEEEESSSS
  96.      /usr/freeware/var/spool/fax/etc/config.devID device-specific
  97.      configuration file
  98.  
  99.      Consult _h_y_l_a_f_a_x(4F) for a complete discussion of the
  100.      structure and content of the spooling area.
  101.  
  102. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  103.      _f_a_x_q(1M), _h_y_l_a_f_a_x(4F), _c_o_n_f_i_g(4F)
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Page 2                                          (printed 6/24/99)
  130.  
  131.  
  132.  
  133.